home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / scopedisk24 / IconLab1.1 / ICONLAB.doc < prev    next >
Text File  |  1988-08-26  |  16KB  |  305 lines
  1.  
  2.                          HERMES' ICONLAB  (Version 1.1)
  3.  
  4.  
  5.                        Copyright (c) 1988 A. G. Kartsatos
  6.  
  7.                               ***  Shareware  ***
  8.  
  9.      TO RUN IT IMMEDIATELY:
  10.                        CLI: PRESS "ICONLAB" or "RUN ICONLAB". 
  11.                  WORKBENCH: CLICK into the ICONLAB icon.
  12.  
  13.      TO EXIT:               PRESS the TAB KEY or CLICK into the LONG RECTANGLE                            
  14.                             at the BOTTOM RIGHT of the screen.  To get out 
  15.                             from a LARGE ICON or A LARGE PICTURE, JUST CLICK 
  16.                             INTO IT.
  17.  
  18.      PLEASE TRY NOT TO MULTI-TASK THIS PROGRAM.  IT USES A LOT O MEMORY FOR
  19.      THE BITMAPS OF PICTURES AND BRUSHES.
  20.  
  21.      First of all, I would like to thank all my friends out there who took
  22. the time to study the first version of this program and send me their comments
  23. and their suggetions.  Special thanks are due to Barb Hamilton (Elverta, CA) 
  24. and Jeff White (The Wizard, Tampa, FL).  I hope that I have corrected all the
  25. bugs that I have discovered or have been reported to me.
  26.  
  27.      This is the definitive work on icons on the Amiga computer.  In addtion
  28. to its ability to show and save icons (Version 1.0) it can now do the 
  29. following: 
  30.    
  31.      SPLIT ICONS
  32.      JOIN ICONS
  33.      SHOW BRUSHES AS ICONS (What they would look like if you made icons out
  34.                             them.  They are shown in your personal Workbench
  35.                             colors and MEDIUM resolution)
  36.      SHOW BRUSHES AS IFF PICTURES
  37.      SAVE ANY BRUSHES AS ICONS
  38.               
  39.      It works with any size icons and/or brushes including sizes that fill
  40. the entire screen.
  41.      To LOAD an ICON, just click into its name on the left and then click
  42. into the LOAD gadget.
  43.      To VIEW A BRUSH or an IFF PICTURE, just click into its name on the left 
  44. and then click into the SHOW gadget.
  45.  
  46.      NEW GADGETS:
  47.  
  48.      (1)     SPLIT:    SPLITTING an icon, means creating an icon whose image
  49.                        is the alternate image of the given icon.  Thus, you
  50.                        CAN ONLY SPLIT ICONS WITH TWO IMAGES.  
  51.   
  52.                        LOAD an icon and click into the SPLIT gadget.  If the
  53.                        icon has two images, you will be asked to enter the
  54.                        name of the new icon (whose image will be second image
  55.                        of the loaded icon).  Enter a valid pathname, like
  56.                        DF0:Baby, or DH1:Hello/Baby, or just Baby.  You don't
  57.                        need to add .info at the end.  The program will do
  58.                        that for you.  But, if you do add .info, no problem.
  59.                        
  60.                        Now, if you want AN ICON WITH THE FIRST IMAGE OF THE
  61.                        LOADED ICON, just save the present icon with high-
  62.                        lighting BACKFILL or COMPLEMENT, but not IMAGE.
  63.  
  64.      (2)     JOIN:     JOINING TWO ICONS, means creating a new icon with
  65.                        images from both icons.  For example, let's say you
  66.                        have two icons with names Baby.info and Fires.info.
  67.                        You want to make a new icon whose first image is
  68.                        the first image of Baby.info and its second image is
  69.                        the first image of Fires.info.  Thus, you want to cre-
  70.                        ate a two-image icon from the first images of the two
  71.                        given icons.  Let's say the name of the resulting icon
  72.                        is DF1:BabyFires.info.  Here is how you do it:     
  73.    
  74.                        1. LOAD the icon Baby.info.
  75.                        2. Click into the SPLIT gadget.
  76.                        3. Enter the name DF1:BabyFires in the requestor gadget.
  77.         
  78.                        That's it!  The program will inform you as to whether
  79.                        your new icon has been created.
  80.  
  81.      (3)     SHOW:     This gadget allows you to view a BRUSH (or any IFF
  82.                        picture) in two ways: 1.  You can view it as an ICON.
  83.                        This means that you can view your brush or IFF in the
  84.                        colors of your Workbench and MEDIUM resolution.  MEDIUM
  85.                        resolution is the resolution of a normal Workbench.
  86.                        Thus, no matter what the resolution or size of your IFF
  87.                        is, you'll see it as if you had created an ICON from
  88.                        it.  This you can certainly do with the next gadget.
  89.                
  90.                        2.  You can view it as an IFF file.  Well, you know
  91.                        what this means.  You just view the brush/picture
  92.                        in its colors.  However, if the brush is an incomplete
  93.                        IFF file, IT IS SHOWN ONLY IN MEDIUM RESOLUTION.  The
  94.                        IFF files/brushes we are talking about here, could be
  95.                        OVERSCAN pictures in any resolution.  Naturally, if the
  96.                        picture is a 4-color MEDIUM resolution one, the ICON
  97.                        viewing is identical to the IFF viewing, except for
  98.                        the fact that a brush will be centered on your screen. 
  99.  
  100.                        Now, take notice of the fact that when you show a HIRES
  101.                        (640x400) picture as a MEDRES (640x200) picture, you
  102.                        lose the lower 200 lines!  So, don't be surprised, when
  103.                        this takes place with HIRES pictures shown as ICONS.
  104.                        
  105.                        Also, if you want to SAVE a picture that you are cur-
  106.                        rently viewing as an icon, just have your HERMiT on.
  107.                        This program is like GRABBiT and you will love it.
  108.  
  109.                        Just click into the file name on the left, and then
  110.                        click into the SHOW gadget.  If your file is a legiti-
  111.                        mate IFF/BRUSH file, a requestor will ask you whether
  112.                        you want to view it as an IFF picture or as a BRUSH.
  113.  
  114.                        You can do either one of these.  However, if you 
  115.                        cannot see a brush as an IFF picture (believe it or
  116.                        not, there are some overscan brushes out there) try
  117.                        the PANIC button.  It might work!  The PANIC button
  118.                        tries to depict a brush as a LOWRES overscan picture
  119.                        starting at the coordinates (-16,0).  It has worked
  120.                        with the BrushWorks LORES brushes.  I would like to
  121.                        thank David Stanton (Ohio) for pointing those brushes
  122.                        out to me.
  123.   
  124.                        "Res." on the Brush Window stands for RESOLUTION.  It
  125.                        will give you the resolution of an IFF picture.  There
  126.                        is no resolution for a brush!  Just bitplanes. 
  127.  
  128.                        CLICK INTO THE SCREEN to get rid of the IFF/BRUSH 
  129.                        screen and get back into the main panel.
  130.          
  131.                        This function can be particularly useful when you want
  132.                        to cut a piece of a picture as a brush for an icon 
  133.                        (using Deluxe Paint) and you would like to know what
  134.                        that picture looks like with your Workbench colors and
  135.                        resolution.  You also want to check which piece looks
  136.                        good for a potential icon.
  137.    
  138.       
  139.      (3)     B-->I:    This means BRUSH TO ICON.  You use this gadget to create
  140.                        an icon from a given brush.  A brush is nothing else
  141.                        than your usual IFF picture with dimensions smaller 
  142.                        than those of the normal IFF's.  For example a brush 
  143.                        can have width 50 and height 125, but regular IFF format
  144.                        picture files start at width 320 and height 200.
  145.                        You CAN SAVE ANY BRUSH INTO AN ICON!  This includes
  146.                        even overscan pictures.  But REMEMBER: The icon will
  147.                        carry the colors of your Workbench and MEDIUM resolu-
  148.                        tion (the normal Workbench resolution).  To see what
  149.                        your icon would look like (coming out of a brush), use
  150.                        the ICON option of the SHOW gadget.
  151.  
  152.                        To use BRUSH TO ICON, just click into a BRUSH/IFF file
  153.                        name on the left and then click into the B-->I gadget.
  154.                        If the file is legitimate,  the program will ask you for
  155.                        the name of the resulting file.  Enter a legitimate
  156.                        file name (you can include paths) and there is your
  157.                        icon!  
  158.                        
  159.      The program will refresh the listing of the files after each saving or
  160. deletion.  It will do that even if you save into another volume/directory.
  161.      Please do not click too fast into the file names on the left.  Press 
  162. firmly on the left mouse button to see the white hilighting first.
  163.  
  164.      THIS IS A SHAREWARE PROGRAM. 
  165.  
  166.      IF YOU USE THE PROGRAM, PLEASE SEND $15.00 TO
  167.  
  168.                    A. G. Kartsatos
  169.                    8524 Caladesi Island Drive
  170.                    Tampa, FL 33637, USA
  171.  
  172.      Other programs by the author:
  173.  
  174.      PALETTA.ARC    (Color Mixing, Modifying IFF's, Random Colors)
  175.      CALCULA.ARC    (An Expression Parser And A Function Evaluator.  Unique!)
  176.      SIMPLICA.ARC   (The Simplex Method Of Linear Programming)
  177.      ROST.ARC       (Reports On Storage And Tasks On Their Windows. Useful!)
  178.      LISTA11.ARC    (Very Useful Directory Lister.  Alpha, Bytes, Patterns,
  179.                      CLI, Refresh.  Opens Its Own Window)
  180.      SCRIPTA.ARC    (Online!-PCP Script Maker.  Easy Online! Script Files!)
  181.      FORMULA!.ARC   (FORMIDABLE 3D-Grapher In C. It graphs z = f(x,y).  Choice
  182.                      Of Colors.  17 Functions Supported.  An Artist's Tool)
  183.      FINANCA.ARC    (Mortgage, Compound Interest And Annuity)
  184.      CONTOURA.ARC   (SPECTACULAR Contour Grapher.  Definitely An Artist's
  185.                      Tool.  CENTER, ZOOM IN, ZOOM OUT, FLOWING PALETTE...)
  186.      ARCHA11.ARC    (ARC-PAK-ZOO Utility.  It Also Has Another 12 Utility
  187.                     Gadgets And 7 Drive Gadgets.  Only 29K, It Can Be Used
  188.                     As An Efficient Directory Utility)
  189.      DUHERM27.ARC   (Beautiful Directory Utility.  A multitude Of Functions.
  190.                     72 Gadgets Out Of Which 48 Are User-configurable! 
  191.                     One Of The Major Powerful DirUtils For The Amiga)
  192.      VIEWOVER.ARC   (This Is The Program View (V. 1.8) With Overscan 
  193.                     Capability By HERMES.  Very Small (About 6K) And Very
  194.                     Convenient)
  195.      HERMIT.ARC     (This Program Allows You To Save/Cycle Your Front Screen.
  196.                      It resides In The Background And "Listens" To Your Key-
  197.                      board For HOT KEYS.  Nice And Only About 15K Long)
  198.  
  199.      Feel free to distribute this program, with this doc intact, to any
  200. bulletin boards and other non-profit establishments in the US and abroad.
  201.      You may also upload this program to major boards like Compuserve, 
  202. Delphi, GEnie, PLink, etc.
  203.      The inclusion of this program, or any part of it, in any form in a 
  204. commercial package, or its use for any commercial purposes, requires the 
  205. written permission of the author.
  206.  
  207.     FOR SUPPORT, CALL *HERMES BBS* IN TAMPA, FL.    
  208.     TELEPHONE: 813-985-7624.  70 MEG OF STORAGE, 1500 FILES ONLINE, GOOD
  209. MESSAGE BASE.
  210.     ALTHOUGH IT IS A PRIVATE BOARD, YOU MAY LEAVE A MESSAGE TO THE SYSOP
  211. CONCERNING ANY QUESTIONS OR COMMENTS YOU MIGHT HAVE ABOUT HERMES' PROGRAMS.
  212.  
  213.     The usual disclaimers apply concerning the use of software.  Although I
  214. and other people have tested this program before release, use at your own
  215. risk.
  216.     I would really appreciate knowing your comments and suggestions.  In the
  217. meanwhile have fun with this program and remember that it is SHAREWARE!
  218.     So long!
  219.  
  220.                       @@-->>> HERMES
  221.  
  222.  
  223.                          HERMES' ICONLAB  (Version 1.0)
  224.  
  225.  
  226.      Here is a nice program that will let you see your icons and their
  227. alternate images without having to go to the Workbench.
  228.      I wrote it because I am tired of having to construct a new icon for
  229. a drawer in order to see all the icons in it from the Workbench.
  230.      I also don't like to scroll a Workbench window to see the icons in it
  231. when it is full of them.
  232.      The program will also allow you to change various icon parameters like
  233. ICON TYPE, HIGHLIGHTING, DEFAULT TOOL, TOOL TYPES and STACK.
  234.      To SEE an ICON, choose it from the file requester table and then click
  235. into the LOAD gadget.  To see its ALTERNATE image, just click into the TOGGLE
  236. gadget.  You can thus toggle between the two images of an icon provided there 
  237. is an alternate image.  Just because an icon changes colors when you click
  238. into it, it does not necessarily mean that there is an alternate image.
  239.  
  240.      GADGETS:   
  241.  
  242.      9 DRIVES:
  243.  
  244.             The nine DRIVE gadgets on the left allow you to attach to anyone
  245. of those drives.  If you don't have VD0:, or VDK, or any one of the other 
  246. drives, it does not matter.  Just cancel the requestor when it shows up.
  247.             The program starts by attaching first to your RAM: volume.  From
  248. THEN on you can attach to any one of 9 drives by clicking into them.  YOU CAN
  249. ALSO ATTACH TO ANY DRIVE/DIRECTORY BY ENTERING IT INTO THE DRAWER GADGET AND
  250. THEN PRESSING <RETURN>.
  251.  
  252.      PARENT:   This gadget allows you to attach to the parent directory, if
  253.                you are not already at the top.
  254.  
  255.      LOAD:     The LOAD gadget loads an icon into the large rectangular area
  256.                on the right.  If the icon is bigger than that area, it auto-
  257.                matically gets loaded into its own window, whose dimensions
  258.                are commensurable with those of the icon itself.  Before you
  259.                load an icon, you must click into its name (ending with .info)
  260.                first.  
  261.  
  262.      SAVE:     You may change the following characteristics of an icon:
  263.  
  264.                ICON TYPE,
  265.                HIGHLIGHTING,
  266.                DEFAULT TOOL,
  267.                TOOL TYPES,
  268.                STACK
  269.  
  270.                You should always use the up/down arrows to change the para-
  271.                meters in ICON TYPE and HIGHLIGHTING.  You can thus change
  272.                ANY icon type to ANY other icon type very easily. Do not change
  273.                the highlighting to IMAGE if the icon does not already have an
  274.                ALTERNATE image.  Remember:  if you change the ICON TYPE to
  275.                DISK and its name is disk.info, you usually need to reboot 
  276.                in order to see the icon on the Workbench. Actually, I attach
  277.                to the directory with the new disk icon and then I LoadWb.
  278.                This should do it too!  You can load your Workbench several
  279.                times.  You do not have to exit CLI after LoadWb.
  280.                The SAVE gadget saves the icon to the pathname given by the
  281.                user in the DRAWER/FILE gadgets.  The program does check to
  282.                see if the volume/directory in the DRAWER gadget exists.
  283.                Make sure that the parameters on the right are the ones that
  284.                you actually want to save.  Again, use the ADD and DEL gadgets
  285.                in order to ADD and DELETE TOOL TYPES, respectively.  Otherwise,
  286.                your icons will not be saved right.       
  287.     
  288.      TOGGLE:   Toggles between the main and the alternate image of the icon
  289.                that has been loaded.
  290.  
  291.      DELETE:   Deletes the file whose pathname is in the DRAWER/FILE gadgets.
  292.  
  293.   ATTENTION:   (1)  If your icon is TOO BIG, its window will not have a TOGGLE
  294.                and an EXIT gadget.  Just PRESS "T" or "t" to see its alter-
  295.                nate icon and "Q" or "q" (or just click into it) to exit into 
  296.                the main window.
  297.  
  298.                (2)  If you get the message: "Cannot Open The Icon Window",
  299.                EXIT the program because you don't have enough memory left to
  300.                open a large icon's window.
  301.  
  302.                            @@-->>> HERMES
  303.   
  304.  
  305.